home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / fill402.zip / FILL.DOC < prev    next >
Text File  |  1994-02-06  |  15KB  |  299 lines
  1. FILL.DOC
  2. 02/06/94
  3.  
  4. The FILL program is designed to help you move or copy files off a hard disk
  5. while reducing the amount of wasted space on the destination disks.  Internally,
  6. it does this by sorting the file names so the largest files are moved/copied
  7. first.  It then moves or copies whatever files can fit on the floppy, skipping
  8. any that can't.  Features:
  9.  
  10.   * Can either move or copy the files to the resulting location
  11.   * Can go onto to multiple diskettes as desired, beeping if desired when
  12.     the next disk is expected
  13.   * Can move the files in file name order or any of standard ordering
  14.     categories
  15.   * Can be used to split up files which are too big to fit on a single disk
  16.   * Can create a status/transaction file for you, showing what was copied/moved
  17.   * Can label the output diskette, providing some patterns like sequence numbers
  18.     and dates which it will fill in for you
  19.   * Some times useful for network transfers where standard MOVE command doesn't
  20.     always work
  21.   * Can review and delete if desired any files which are already in the
  22.     output destination (e.g. already on the output diskette)
  23.   * Can reformat the whole disk if files are going to drive A or B
  24.  
  25. Some of the default values for this routine can be set using the CONFIGWS.EXE
  26. program contained in FILLymm.ZIP.
  27.  
  28. Limits:
  29.   * Routine can only process the first 500 files in a given subdirectory.  It
  30.     ignores the rest of them.
  31.   * Routine can only review for deletion the first 200 files in the output
  32.     location.
  33.   * Routine does not provide any cool write-error recovery.  If it finds a DOS
  34.     error on the output drive, it just stops.
  35.   * Routine will not format the output diskette for you.
  36.   * Routine's continual testing for new diskette (/CONTINUAL) only works if the
  37.     diskette was formatted using DOS 4.0 or later.  That's the version that
  38.     puts volume sequence numbers on the diskettes.  One way to insure this if
  39.     you're using the newer versions of DOS is to do a quick-reformat of your
  40.     floppies whenever you'd normally do a DEL A:*.*.  I do this with a QDR.BAT
  41.     command that has the following:
  42.  
  43.         FORMAT %1 /Q /U /V:Bruce
  44.  
  45.     I then say "QDR A:" or "QDR B:".  It invokes an unconditional quick format
  46.     and applies a volume label on the diskette (to avoid the prompt).  If the
  47.     diskette does not have a sequence number, DOS tells you it can't be
  48.     quick-formatted and asks if it can do the full format instead.
  49.  
  50.  
  51.  
  52. Syntax:
  53.  
  54.     FILL [ source-filespec ] [ dest-drive: | dest-drive:\path\ ]
  55.       [ /MOVE | /COPY ] [ /PROMPT | /-PROMPT ]
  56.       [ /OVERWRITE | /-OVERWRITE | /OVERSKIP | /OVERASK ]
  57.       [ /Ox | /O-x ] [ /Xfilespec ]... [ /WIPE | /-WIPE ] [ /MULTI | /SINGLE ]
  58.       [ /SPLIT ] [ /LABEL=label [ /START=n ] ] [ /Fstatfile [ /S+ | /S- | S* ]
  59.       [ /CONTINUAL ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  60.  
  61. where:
  62.  
  63. "source-filespec" is the file specification for what you want to move.  You can
  64. specify a drive and path and file wildcards if necessary (e.g.  "C:\TEMP\*.BAT")
  65. but otherwise it defaults to your default drive and directory and takes "*.*".
  66. Note that the program cannot handle any request for more than 500 files at a
  67. time.
  68.  
  69. "dest-drive:" or dest-drive:\path" tells the routine what drive or path to move
  70. the files to.  In many cases, the routine doesn't really care whether the source
  71. specification precedes or follows the destination specification.  If either
  72. parameter ends with a colon (e.g.  "A:") or slash (e.g.  "C:\QB45\"), the
  73. routine will presume that's the destination specification and the other one must
  74. be the source specification.  If either parameter contains a wildcard, the
  75. routine will presume that's the source specification and the other one must be
  76. the destination specification.  So "FILL A:  *.BAS" is the same as "FILL *.BAS
  77. A:".  The default destination drive (dest-drive:, not dest-drive:\path) can be
  78. set by using the CONFIGWS.EXE program.  The original default is "A:".
  79.  
  80. "/MOVE" says to move the files instead of copying them.  The default value for
  81. this option can be set by using the CONFIGWS.EXE program.  The original default
  82. is "/MOVE".
  83.  
  84. "/COPY" says to copy the files instead of moving them.  The default value for
  85. this option can be set by using the CONFIGWS.EXE program.  The original default
  86. is "/MOVE".
  87.  
  88. "/PROMPT" says to prompt for each filename before moving it.  The default value
  89. for this option can be set by using the CONFIGWS.EXE program.  The original
  90. default is "/-PROMPT".
  91.  
  92. "/-PROMPT" says to not prompt for each file.  The default value for this option
  93. can be set by using the CONFIGWS.EXE program.  The original default is
  94. "/-PROMPT".
  95.  
  96.  
  97. "/OVERWRITE" says to overwrite same-named files in the destination path.  The
  98. default value for this option can be set by using the CONFIGWS.EXE program.  The
  99. original default is "/OVERSKIP".
  100.  
  101. "/-OVERWRITE" says to abort if any same-named files are found in the destination
  102. path.  The default value for this option can be set by using the CONFIGWS.EXE
  103. program.  The original default is "/OVERSKIP".
  104.  
  105. "/OVERSKIP" says to skip any file that already exists in the destination path.
  106. The counts aren't accurate in this case.  The default value for this option can
  107. be set by using the CONFIGWS.EXE program.  The original default is "/OVERSKIP".
  108.  
  109. "/OVERASK" says to prompt if same-named files exist in the destination
  110. directory.  The default value for this option can be set by using the
  111. CONFIGWS.EXE program.  The original default is "/OVERSKIP".
  112.  
  113. "/Ox" and "/O-x" allow you to specify the copy order for the files.  "x" can be
  114. one of the following:
  115.  
  116.         N = file name
  117.         D = file date and time
  118.         S = file size
  119.  
  120. If you precede the "x" with a dash ("-"), the sort will be done in reverse
  121. order.  Note that this parameter does not determine which files are copied; it
  122. only determines what order they are actually copied.  Since the order that the
  123. file tends to show up in a DOS DIR listing is based on creation order, this
  124. sequence may be relevant to how the files ultimately show up.  The default value
  125. for this option can be set by using the CONFIGWS.EXE program.  The original
  126. default is "/ON".
  127.  
  128. "/Xfilespec" says to exclude certain filespecs from being moved.  You can
  129. specify up to 10 exclusion parameters but each must have their own /Xfilespec
  130. statement.  For example, to move all files except those with a BAS extension,
  131. you could say "FILL /X*.BAS".
  132.  
  133.  
  134. "/WIPE" says that if the destination drive has files on it, prompt the user
  135. for whether these files should be deleted or not.  Six sub-options show up in
  136. this case:
  137.  
  138.     Do *NOT* delete the x file(s)    Don't delete anything
  139.     List file(s)                     List the files but don't delete any of
  140.                                      them.  The user will be reprompted for
  141.                                      these four options after pressing a key.
  142.     Select file(s) to delete         List the files and allow the user to
  143.                                      select any to be deleted.  Keys:
  144.                                         * Cursor keys -- move among list
  145.                                         * Space       -- select that file
  146.                                         * Ctrl-Enter  -- select all files
  147.                                         * Ctrl-bs     -- deselect all files
  148.                                         * Enter       -- process those tagged
  149.                                         * Esc         -- skip processing
  150.                                      After pressing Enter, the selected files
  151.                                      will be deleted.  You will then get the
  152.                                      standard four prompts again.
  153.     Delete all file(s)               Delete all files in the specified
  154.                                      directory.  Subdirectory files will not
  155.                                      be deleted.
  156.     Reformat the diskette            If your output drive is either A or B,
  157.                                      the program will shell to DOS and execute
  158.